Pull Request

Description

Agents have been bypassing spell-checking by adding misspelled words to .cspell.yaml. This applies demaconsulting/ContinuousCompliance#26 to add explicit policy guardrails.

• .cspell.yaml: Adds three policy lines to the PURPOSE block — misspelled words must be fixed at source, never added to the word list; genuine technical terms require a reviewed proposal before being added. Removes the misleading (update as needed) hint.
• AGENTS.md: Adds a Spell check word list policy subsection under Key Files. Spells out the fix-vs-propose distinction explicitly for agent consumers, with the proposal wording set to "(e.g. comment in a pull request)".
• CONTRIBUTING.md: Replaces the misleading "Add project-specific terms to .cspell.yaml" guidance in the Spell Checking section with the same fix-vs-propose policy, ensuring consistency for human contributors.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code quality improvement

Related Issues

Pre-Submission Checklist

Before submitting this pull request, ensure you have completed the following:

Build and Test

• Code builds successfully: dotnet build --configuration Release
• All unit tests pass: dotnet test --configuration Release
• Code produces zero warnings

Code Quality

• Code formatting is correct: dotnet format --verify-no-changes
• New code has appropriate XML documentation comments
• Static analyzer warnings have been addressed

Quality Checks

Please run the following checks before submitting:

• Spell checker passes: cspell "**/*.{md,cs}"
• Markdown linter passes: markdownlint "**/*.md"
• YAML linter passes: yamllint .

Testing

• Added unit tests for new functionality
• Updated existing tests if behavior changed
• All tests follow the AAA (Arrange, Act, Assert) pattern
• Test coverage is maintained or improved

Documentation

• Updated README.md (if applicable)
• Updated ARCHITECTURE.md (if applicable)
• Added code examples for new features (if applicable)
• Updated requirements.yaml (if applicable)

Additional Notes

Upstream reference: demaconsulting/ContinuousCompliance#26

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.